The Outland TCP Tool is a connection tool for the Communications Toolbox. It uses the MacTCP driver to communicate over TCP/IP networks. The tool supports synchronous and asynchronous open, close, listen, read, and write.
This is not a Telnet tool! If you want to connect to the Telnet port, 23, you are probably not going to have much luck. The Outland TCP Tool provides a raw TCP connection only.
In the settings dialog, you can enter an IP address and port number. If you are using the tool to open a connection, the address and port number are of the TCP port you are connecting to. If you are using the tool to listen for an incoming connection, the address is ignored (it is always the local machine), and the port is the port number to listen on. The port number 0 has a special meaning to the MacTCP driver; using it is not recommended.
You may be freely copy and use this tool for personal, non-commercial activities. For all other uses, contact Outland.
Bill Lipa
outland@aol.com
1-800-PLAY-OUT
Notes:
- Requires System 7 running on a 68020 or better Macintosh.
- To connect two ports on the same computer, your application may need to call CMListen and CMOpen asynchronously. Otherwise the receiving application will not get time to accept the call, and the system will hang.
- This release does not report errors to the user. Instead, a debugging file is produced called "Code Resource Debug". If you are reporting a bug, please include the contents of this file if it is in the same folder as your CTB application.
- This release does not support timeouts or any CTB 1.1 functionality.
Version History
1.0 July 6, 1994
• Final code cleanups and some cosmetic changes.
1.0d6 April 26, 1994
• Fixed a bug where the write routine could return an error code even if called asynchronously. Now the completion routine is always used to handle errors.
• Now uses the asynchronous notification routine as a debugging aid and to change the ULP timeout behavior from abort to report.
1.0d5 April 11, 1994
• Fixed a bug where the read completion routine was never called for asynchronous reads.
• Ignore connectionDoesntExist errors from endSession.
1.0d4 March 31, 1994
• Turned on the TCP push mode for lower lag times.
1.0d3 March 23, 1994
• Fixed a bug where CMStatus would always return cmStatusDWPend.
1.0d2 March 23, 1994
• Fixed a bug where applications that expected to get buffers with default length were instead given zero-length buffers.
• Fixed a bug where addresses that were not in the local cache were erroneously thought to be missing.
• If TCP is not present or could not be initialized, prevent CMOpens from causing a verify failed (which would crash the computer if Macsbug was missing). Instead, return cmFailed.
• When TCP errors such as openFailed are returned from TCPPassiveOpen, return cmFailed instead of passing the error code through. This could confuse applications that depended on seeing CTB error codes. Don't print to the debug file when this particular error occurs.